home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 June / Macworld (1998-06).dmg / Serious Demos / XPublish™ 1.0 for Mac / README < prev    next >
Text File  |  1998-03-18  |  14KB  |  169 lines

  1. XPublish™ 
  2. Release 1.0
  3.  
  4. XPublish (TM) is a professional XML publishing system for efficient authoring, publishing and maintainance of websites. 
  5.  
  6. XPublish let you use XML markup to describe and maintain the content of websites.
  7. Repeated content such as footers can be maintained as XML Entities (includes), eliminating much of the need for error-prone search/replaces.  The integrated Cascading Style Sheets editor makes it easy to define a consistent presentation style for the site. 
  8.  
  9. At your command, the XML documents are automatically published as standard HTML  for deployment on a web server on any platform. XPublish will add a CSS style sheet to the resulting HTML pages, and will optionally emulate the style sheet using presentation markup for older browsers.
  10.  
  11. Using XPublish, you can start benefitting from the efficiency of XML and Cascading Style Sheets today.  XPublish can import and process your current HTML documents without requiring any changes. At your own pace, you can start making use of the various features of XML by adding these to the HTML documents. When you are ready, you can complete converting the previous HTML document into valid XML to ensure optimal processing and interchangability.
  12.  
  13. New versions as well as additional information about XPublish is available from:
  14.  
  15.     http://interaction.in-progress.com/xpublish
  16.  
  17. QUICK START
  18.  
  19. XPublish is plug & play. After starting up, the application present you with a manager for the locations of the site.
  20.  
  21. Double-click the "index" location to open the document in the editor. The document is in XML extended HTML. The markup contains XML Entity References such as  &footer; which will be replaced with the text of a footer at publishing time.  
  22.  
  23. To get an overview of the entities, open the Entities dialog from the File menu. Add a reference to an entity by dragging it from the Entities dialog to the document editor. To create a new entity, choose "New Entity" from the File menu, or drag & drop content on the Entities dialog.
  24.  
  25. Publish the demonstration site by choosing "Publish" from the File menu. XPublish will convert all documents into HTML, and copy other files to the result folder.  All entity references are replaced with their corresponding values. Open any file in the result folder to compare the published HTML to the original XML markup.
  26.  
  27. The CSS Style Sheet is available from the Windows menu, in an editor similar to the Cascade style sheet designer. Set a style for selected elements, then close the dialog. Next time the site is published, the new style will be used.
  28.  
  29. See the XPublish Tutorial for lessons if how to use the basic features of XPublish. 
  30.  
  31. LIMITATIONS
  32.  
  33. The 1.0 version of XPublish has some limitations that we will be working on for the next release. Part of the reason for holding back with these features is to get your feedback so the features can be implemented to be as useful as possible. Most of the limitations relate to authoring and processing of XML markup even if all XML 1.0 constructs should be possible to use in a document.
  34.  
  35. • No external XML entities are resolved, except for public identifiers for Document Types and external parameter entities in the DTD. External entities in the DTD are resolved by finding a file in the Document Types folder with a name that matches the public id of the entity.
  36. • Parameter entities in the document type declaration subset will not affect conditional marked sections in the DTD.
  37. • Element identifiers should be in upppercase for backward compatability with HTML. Some user interface features may misbehave if you use mixed case.
  38. • The Attlist dialog does not support enumerated attribute types (but enumeration can still be used in declarations).
  39. • Internal entities cannot build markup or make use of a notation.
  40. • No Processing Instructions will be executed.
  41. • Syntax coloring of markup is not yet finished. XPublish may fail to color certain constructs or keep a color for other content.
  42. • The description of a location doesn't have a value for XML and HTML documents.
  43. • Some dialog fields will allow a value even if it doesn't follow XML 1.0.
  44.  
  45. KNOWN PROBLEMS
  46.  
  47. Please report any problem or inconsistency to <xpublish-bugs@in-progress.com> and it will be fixed with the next release.
  48.  
  49. XPublish doesn't handle out-of-memory situations very well. Typically, it will present a cryptic dialog at startup stating that some library is missing, or will produce blank pages at publishing time. the About XPublish dialog will provide information about how much free memory is available for the application. You are advised to ensure that it has at least one megabyte of free RAM.
  50.  
  51. XPublish uses an object database to maintain the a copy of the documents in a preprocessed format for efficient processing of larger sites. The database is in the file called Cache Database. In the event of inconsistent content or behavior, you are advised to quit XPublish, trash the Cache Database file, then restart the application to rebuild the database.
  52.  
  53. LICENSE AND LIMITED WARRANTY AGREEMENT
  54.  
  55. CAREFULLY READ THE TERMS AND CONDITIONS OF THIS LICENSE 
  56. AGREEMENT PRIOR TO USING THIS SOFTWARE. USE OF ANY PORTION 
  57. OF THIS SOFTWARE INDICATES YOUR AGREEMENT TO THE 
  58. FOLLOWING TERMS AND CONDITIONS. IF YOU DO NOT AGREE WITH 
  59. SUCH TERMS AND CONDITIONS, YOU SHOULD NOT USE THE SOFTWARE.
  60.  
  61. Definitions
  62.  
  63. The following definitions apply to the terms as they appear in this 
  64. agreement:
  65.  
  66. • MEDIA DESIGN/IP means MEDIA DESIGN IN•PROGRESS (TM) and TERJE NORDERHAUG
  67. • PACKAGE means the software, manual(s), and any other items accompanying this agreement.
  68. • SOFTWARE means the computer programs contained in XPUBLISH (TM) together with all codes, techniques, software tools, formats, designs, concepts, methods, and ideas associated with these computer programs.
  69. • YOU and YOUR refers to any person or entity that acquires or uses the SOFTWARE.
  70.  
  71. PART I -- TERMS APPLICABLE WHEN LICENSE FEES NOT (YET) PAID
  72.  
  73. PERMITTED USES
  74.  
  75. MEDIA DESIGN /IP grants you a non-exclusive license to use the  SOFTWARE free of charge only if:
  76.  
  77. • Your use of the software is for the purpose of evaluating whether to purchase an ongoing license to the SOFTWARE. The evaluation period is limited to 60 days. 
  78.  
  79. You may:
  80.  
  81. 1. Install and operate the SOFTWARE on only one computer at a time.
  82.  
  83. 2. Make a reasonable number of copies of the SOFTWARE solely for backup or archive purposes, which automatically become the property of MEDIA DESIGN/IP and are subject to this agreement. In any such copies, you must reproduce all copyright notices and other identifying or restrictive legends that appear on the software as received.
  84.  
  85. PROHIBITED USES
  86.  
  87. You may not:
  88.  
  89. 1. Modify the SOFTWARE. Any modified or merged portion of the SOFTWARE is subject to this agreement.
  90.  
  91. 2. Reverse-engineer, disassemble, decompile, or make any attempt to discover the source code or internal technical architecture of the SOFTWARE.
  92.  
  93. 3. Translate or create derivative works based on the SOFTWARE.
  94.  
  95. 4. Remove, obscure, or alter any copyright notice or other proprietary rights related to the SOFTWARE.
  96.  
  97. 5. Transfer, sub-license, sell, lend, rent or lease any portion of the SOFTWARE.
  98.  
  99. 6. Copy any portion of the SOFTWARE, except as described above under permitted uses.
  100.  
  101. PART 2 -- TERMS APPLICABLE WHEN LICENSE FEES PAID
  102.  
  103. PERMITTED USES
  104.  
  105. MEDIA DESIGN/IP grants you a non-exclusive license to use the 
  106. SOFTWARE according to the terms set forth below. You may:
  107.  
  108. 1. Install and operate the SOFTWARE on only one computer at a time.
  109.  
  110. 2. Make a reasonable number of copies of the SOFTWARE solely for backup or archive purposes, which automatically become the property of MEDIA DESIGN/IP and are subject to this agreement. In any such copies, you must reproduce all copyright notices and other identifying or restrictive legends that appear on the software as received.
  111.  
  112. 3. Transfer, after providing written notification to MEDIA DESIGN/IP, all (but no lesser portion) of the SOFTWARE  and related manuals to another person or entity, who will in turn be subject to this agreement. An education entity may not transfer its license to a commercial, for profit entity.
  113.  
  114. PROHIBITED USES
  115.  
  116. You may not:
  117.  
  118. 1. Modify the SOFTWARE. Any modified or merged portion of the SOFTWARE is subject to this agreement.
  119.  
  120. 2. Reverse-engineer, disassemble, decompile, or make any attempt to discover the source code or internal technical architecture of the SOFTWARE.
  121.  
  122. 3. Translate or create derivative works based on the SOFTWARE.
  123.  
  124. 4. Remove, obscure, or alter any copyright notice or other proprietary rights related to the SOFTWARE.
  125.  
  126. 5. Transfer, sub-license, sell, lend, rent or lease any portion of the SOFTWARE.
  127.  
  128. 6. Copy any portion of the SOFTWARE, except as described above under permitted uses.
  129.  
  130. PART III -- TERMS APPLICABLE TO ALL LICENSE GRANTS
  131.  
  132. The SOFTWARE involves valuable proprietary rights of MEDIA DESIGN/IP and others. MEDIA DESIGN/IP retains the title to and ownership of the SOFTWARE and all copyright, trade secret, trade 
  133. name, trademark, and other property rights related to the SOFTWARE, regardless of form that the original or other copies exist in. You may not violate these rights and must take appropriate steps 
  134. to protect MEDIA DESIGN/IP'S rights. MEDIA DESIGN/IP may at any time replace, modify, alter, improve, enhance, or change the SOFTWARE.
  135.  
  136. Both the license and your right to use the software terminate automatically if you violate any part of this agreement. In the event of termination, you must immediately destroy all copies of the SOFTWARE or return them to MEDIA DESIGN/IP.
  137.  
  138. LIMITED WARRANTY
  139.  
  140. MEDIA DESIGN/IP does not warrant that the SOFTWARE will not be corrupted when downloaded from the network. If you discover that the SOFTWARE has been corrupted after downloading, you may repeat the download process until you obtain a non-corrupted copy of the SOFTWARE. MEDIA DESIGN/IP warrants that the SOFTWARE will substantially conform to the specifications established by MEDIA DESIGN/IP. MEDIA DESIGN/IP does not warrant that the SOFTWARE is free from all bugs, errors and omissions.
  141.  
  142. EXCEPT AS SPECIFICALLY SET FORTH ABOVE, MEDIA DESIGN/IP MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED WARRANTIES OF 
  143. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, REGARDING THE USE OR THE RESULTS OF THE USE OF THE SOFTWARE IN TERMS OF ITS CORRECTNESS, ACCURACY, RELIABILITY, CURRENTNESS OR OTHERWISE. THE ENTIRE RISK AS TO THE RESULTS 
  144. AND PERFORMANCE OF THE SOFTWARE IS ASSUMED BY YOU. THE EXCLUSION OF IMPLIED WARRANTIES IS NOT PERMITTED BY SOME JURISDICTIONS. THE ABOVE EXCLUSIONS MAY NOT APPLY TO YOU.
  145.  
  146. EXCEPT AS SPECIFICALLY SET FORTH ABOVE, MEDIA DESIGN/IP WILL IN NO EVENT BE LIABLE TO YOU FOR ANY CONSEQUENTIAL OR INCIDENTAL DAMAGES (INCLUDING BUT NOT LIMITED TO DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTIONS, LOSS OF BUSINESS 
  147. INFORMATION, LOSS OF GOOD WILL AND THE LIKE) ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE EVEN IF MEDIA DESIGN/IP'S LICENSOR HAS BEEN ADVISED OF THE 
  148. POSSIBILITY OF SUCH DAMAGES. BECAUSE SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, THE ABOVE EXCLUSIONS MAY NOT APPLY TO YOU. MEDIA DESIGN/IP'S LIABILITY TO YOU FOR ACTUAL DAMAGES FOR ANY CAUSE WHATSOEVER, AND REGARDLESS OF THE FORM OF THE ACTION, (WHETHER IN CONTRACT, TORT, PRODUCT LIABILITY OR OTHERWISE) WILL BE LIMITED TO THE PURCHASE PRICE YOU PAID FOR THE PRODUCT.
  149.  
  150. DIGITOOL, INC. ("DIGITOOL") AND ITS LICENSOR MAKE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED WARRANTIES OF MERCHANTABILITY 
  151. AND FITNESS FOR A PARTICULAR PURPOSE, REGARDING MCL. DIGITOOL AND ITS LICENSOR DO NOT WARRANT, GUARANTEE OR MAKE ANY REPRESENTATIONS REGARDING THE USE OR THE RESULTS OF THE USE OF MCL IN THE TERMS OF ITS CORRECTNESS, ACCURACY, RELIABILITY, CURRENTNESS OR OTHERWISE. THE ENTIRE RISK AS TO THE RESULTS AND THE PERFORMANCE OF MCL IS ASSUMED BY YOU. THE EXCLUSION OF IMPLIED WARRANTIES IS NOT PERMITTED BY SOME STATES. THE ABOVE EXCLUSION MAY NOT APPLY TO YOU.
  152.  
  153. IN NO EVENT WILL DIGITOOL, ITS LICENSOR, THEIR DIRECTORS,  OFFICERS, EMPLOYEES OR AGENTS BE LIABLE TO YOU FOR ANY CONSEQUENTIAL, INCIDENTAL OR INDIRECT DAMAGES (INCLUDING BUT NOT LIMITED TO DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, LOSS OF GOOD WILL AND THE LIKE) ARISING OUT OF THE USE OR INABILITY TO USE MCL EVEN IF DIGITOOL AND/OR ITS LICENSOR HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  154.  
  155. BECAUSE SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, THE ABOVE LIMITATIONS MAY NOT APPLY TO YOU.
  156.  
  157. Digitool's and it's licensor's liability to you for any cause whatsoever, and regardless of the form of the action (whether in contract, tort (including negligence), product liability or otherwise), will be limited to $50.
  158.  
  159. GENERAL
  160.  
  161. Although MEDIA DESIGN/IP is not responsible for maintaining or helping you use the SOFTWARE, MEDIA DESIGN/IP does at its discretion offer support.
  162.  
  163. This agreement constitutes the entire agreement and supersedes any prior agreement between MEDIA DESIGN/IP and you concerning the contents of this package. MEDIA DESIGN/IP is not bound by any provision of any purchase order, receipt, acceptance, confirmation, correspondence, or otherwise, unless TERJE NORDERHAUG agrees to the provision in writing and the writing includes the signature of TERJE NORDERHAUG. Any written or oral information or advice given by MEDIA DESIGN/IP or TERJE NORDERHAUG will in no way increase the scope of this warranty. Nor may you rely on any such oral or written communication. This agreement cannot be amended, modified or waived, unless the change is written and approved by TERJE NORDERHAUG.
  164.  
  165. WebStar is a trademark of StarNine. MCL is a trademark of Digitool, Inc. Interaction, Interaction in•Progress, in•Progress, and Interaction/IP are trademarks of Terje Norderhaug and Media Design in•Progress.
  166.  
  167.  
  168.  
  169.